home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / tribbs / mc10_02.zip / COMMENT.DOC < prev    next >
Text File  |  1996-04-26  |  8KB  |  170 lines
  1. Customary Disclaimer:
  2.  
  3. Users of MULTI-COMMENT must accept this disclaimer of warranty:
  4.  
  5. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  6. WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  7. LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 
  8. FOR A PARTICULAR PURPOSE.  IN NO EVENT SHALL ANYONE INVOLVED WITH
  9. THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  10. SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  11. OR BREACH OF ANY WARRANTY.
  12.  
  13. This program was written utilizing Mark Goodwins TBAPI.  TriBBS is
  14. copyrighted by Mark Goodwin.
  15.  
  16.  
  17. Copyright notice 
  18. =================
  19.  
  20. MULTI-COMMENT is a copyrighted program being distributed under the shareware
  21. concept.  As such, you may operate MULTI-COMMENT for a period of 30 days
  22. without registering the software.  After the 30 day evaluation period, you
  23. must register your copy of MULTI-COMMENT of you will be in violation of the
  24. United States and International copyright laws.
  25.  
  26. What it does
  27. =================
  28. MULTI-COMMENT is a replacement for the TriBBS internal comment to sysop.
  29. The sysop has the ability to configure up to 10 people the user can choose
  30. to leave the comment to.  (It would be easy to add more, but does
  31. anyone need more than ten?)  An optional description for each sysop
  32. can be included, and the sysop can configure which conference each sysop
  33. is to receive their comment in.  After the user chooses which sysop they 
  34. want to leave the message too, they enter the subject.  If the conference 
  35. is an alias conference they will then be asked if they want to use their 
  36. alias.  After that they go to the message editor.  They can enter their 
  37. message, upload a message, or attach a file to their message.  If they 
  38. choose to upload a message or attach a file TTPROT or FTTPROT is called to
  39. process the upload.  If the user attached a file it will be unarchived
  40. if the proper archive for that file has been configured and exists in the
  41. path.  After the attached file is unarchived the virus scanner is called
  42. to test the file if so configured.  Scan, Thunder Byte, and F-Prot are
  43. supported.  When a user attempts to attach a file that already exists
  44. in the MWORK directory they are informed that they can't upload that
  45. file since it already exists.  Also the minimum attachment security level
  46. is comapred to the users security level, and if they don't have a high
  47. enough level they will not have access to that option.
  48.  
  49. When the user saves the message it is recorded in the callers.log in the
  50. same format as TriBBS uses.
  51.  
  52. Installing
  53. =================
  54.  
  55. To install MULTI-COMMENT make a directory on you hard drive named MC
  56. (or any other name you desire) and copy all of the program files into 
  57. that directory.
  58.  
  59. Next edit COMMENT.CFG to reflect your configuration.  The included config
  60. is already documented for all options so I will not document them again
  61. here.  MULTI-COMMENT uses DOOR.SYS as the drop file. When used off of a menu
  62. TriBBS will generate the drop files, and MULTI-COMMENT will locate and use
  63. the correct drop file.  Edit your batch file to be executed when
  64. TriBBS calls it and it will be ready to go.  
  65. The batch file for a single node bbs will look similar to the following:
  66.  
  67. CD\
  68. CD\TRIBBS\MC\
  69. COMMENT
  70. CD\
  71. CD\TRIBBS
  72. BOARD
  73.  
  74. To replace the TriBBS internal Comment to Multi-Comment edit your
  75. main.mnu in each nodes nwork directory as follows.
  76.  
  77. Was:
  78. C,C,Comment To Sysop,0
  79.  
  80. Change To:
  81. Z,C,Comment To Sysop,0
  82.  
  83. The batch file called when the user chooses comment will be MAINZ.BAT
  84. in the above example.
  85.  
  86. **IMPORTANT**  TTPROT or FTTPROT must be activated in the config.  If
  87.                neither of them is activated the upload a message and
  88.                attach a file options will not be available!
  89.  
  90. **IMPORTANT**  The directory for any unarchiver you use (PKUNZIP etc..) 
  91.                and any scanner you use (SCAN etc..) and either TTPROT or 
  92.                FTTPROT must be included in your path statment.  When 
  93.                Multi-Comment shells out to receive, unarchive, or scan a 
  94.                file the path is searched for the specified EXE.
  95.  
  96.  
  97. Multi-Node configuration
  98. ==========================
  99. Multi-Node installation is fairly easy.  Copy the files into their own
  100. directory as above.  Next make a cfg file for each node that will be
  101. using multi-comment.  You can name these files any legal dos filename,
  102. but I would recomend naming them in such a way as to be helpful in 
  103. pointing out which node they belong to.  For example NODE1.CFG, NODE2.CFG,
  104. etc.  Edit the cfg for each node so that the BBSDIR parameter points
  105. to that node's directory, and edit the Node parameter to reflect the proper 
  106. node number.  (Share.exe should be loaded in your autoexec.bat also.)  Next 
  107. make the batch file for each node.  They will be the same as the above 
  108. except be followed by the name of the cfg file.  MULTI-COMMENT loads 
  109. COMMENT.CFG by default.  The command COMMENT NODE1.CFG will override the 
  110. default and load the NODE1.CFG.  That's all there is to multi-node use, 
  111. just make sure that you have a seperate cfg for each node, and that it 
  112. points to the proper node dir.
  113.  
  114. Menu's
  115. ==================
  116. Included with Multi-Comment are two sample menu's SYSMENU.ANS and ASC.  
  117. If these menus exist when Multi-Comment is executed they will be displayed 
  118. instead of the internal menu.  You can optionally use a SYSMENU.RIP menu if 
  119. you wish to make one.  The only thing you need to make sure when making 
  120. your menu is that you try and keep it about 1/2 screen in size so that it 
  121. doesn't scroll as additional input is requested from the user. Each sysop 
  122. listed in your menu must be included in the COMMENT.CFG, and must be in the
  123. same order.  (Sysop one in the custom screen must be the same as sysop one 
  124. in the config.)
  125.  
  126. The Rip detection routine used in the door driver I use does not always
  127. detect Rip properly with some terminals.  I have been assured that this
  128. has been fixed in the updated driver which should be released soon.  Because 
  129. of this SYSMENU.RIP may not be displayed for all RIP callers.  If the
  130. rip detection fails SYSMENU.ANS will be displayed instead.  Also RIP is
  131. never displayed in the local screen.  The new driver is rumored to support
  132. local rip so that may be a feature in the future.
  133.  
  134. TEMPn
  135. ==================
  136.  
  137. Multi-Comment will create a temporary directory in it's working directory
  138. for each node that uses it.  This directory will have the name Temp1 for
  139. node 1, Temp2, for node 2 etc.  When Multi-Comment is called this directory
  140. is created if it doesn't already exist.  This temporary directory is used
  141. to temporarily store an uploaded message, or attached file while they are
  142. being processed.  Upon exit and startup the contents of this temporary 
  143. directory are cleaned out.
  144.  
  145. Shareware limitations
  146. ======================
  147. The only limitation to Multi-Comment is an unregisterd message when the door 
  148. is first executed.  The registered version will not display this message.
  149.  
  150. Registration
  151. ======================
  152. If you like Multi-Comment and would like to register it fill out the
  153. registration form included in this archive.  Registration is only $5.00.
  154.  
  155. Suggestions
  156. =====================
  157. If you would like something added to Multi-Comment drop me a note, if I
  158. like the idea I will add it if possible.
  159.  
  160. If you have an idea for a TriBBS 10.0 utility that you can't find drop
  161. me a line and explain it.  I may already be working on it, but if I'm
  162. not and do make the utility I will give you a free registration for the
  163. suggestion.  My contact information is included in the registration form.
  164.  
  165.  
  166. Acknowledgments
  167. =====================
  168. Torrance Jones.  Suggested that the conference the comment is posted in
  169.                  be made configurable.
  170.